Welcome to the Upstream User Guide! Upstream is an intuitive and user-friendly R Shiny application designed for barrier culvert restoration planning in Western Washington. This guide serves as both a technical manual and a comprehensive overview of the app’s functionalities, including its core features: Explore, Suggest, Custom, and Learn.
Upstream is more than just a tool; it’s a solution crafted to simplify complex planning processes in environmental restoration. Whether you’re a seasoned expert or new to the field of barrier culvert restoration, this guide will help you harness the full potential of Upstream.
In this guide, you’ll find detailed explanations of each feature:
Explore: Delve into data and visualize culvert attributes across various boundaries.
Suggest: Receive tailored restoration plans based on your specific constraints and budget.
Custom: Create and assess the impact of your own set of restoration projects.
Learn: Learn about how to utilize the app its development.
Our aim is to provide you with all the information you need to make informed decisions and streamline your planning process. With helpful tips, step-by-step instructions, and links to related resources, this guide is your comprehensive companion in utilizing Upstream effectively.
To get started, select a tab above for detailed insights into each of Upstream’s unique features. Dive in and discover how Upstream can enhance your restoration planning experience!
The Explore feature is designed to visualize and plot culvert attributes across various administrative and hydrological boundaries.
Choose the ‘Explore’ tile on the Upstream landing page or select the corresponding tab. This feature automatically shows the entire WDFD culvert inventory for western Washington, updated to the latest version in Upstream. It filters out natural barriers and any barriers situated upstream of natural barriers.
Zoom into your area of interest and click on a culvert to access detailed information. The callouts provide insights into:
To refine the inventory data, use the dropdown menu to select Water Resource Inventory Areas (WRIAs) of interest. For multiple selections, ensure ‘All WRIAs’ is deselected. Similarly, selecting specific ownership types will filter the maps and figures accordingly.
This section allows you to plot variables as a histogram or scatterplot. For instance, to analyze the relationship between the cost of culvert repairs and the length of blocked habitat:
Adjust the plot’s appearance using the jitter sliders.
Click “Submit” to generate two outputs:
Note: The ‘Select Variable for Map’ and ‘Plot Fill Color’ options enhance the visualization of the selected variable on both the map and scatter plot.
The Suggest feature returns a restoration plan that maximizes habitat, given the users budget, project area, and other constraints.
To initiate the Suggest feature on the Upstream platform, simply select your project area, define your budget, and choose the culvert ownership types. This process, accessible in the Suggest section, is straightforward and user-friendly, allowing you to quickly set the parameters for your habitat restoration plan.
As with Upstream’s Explore feature, WRIA’s, sub-areas, and ownership type can be customized in Suggest to meet the needs of the user through a series of drop-down menus (see “Explore” tab section for more on this). For example, on the right we allow for Upstream to suggest culverts of all ownership types in all sub-areas within the Chambers-Clover WRIA only.
Once an these fields are populated, provide the budget available for repairs in US dollars—such as 80000 in the example to the right.
Without additional selections (see below), clicking “Submit” will provide two products:
In addition to spatial and administrative constraints, users can pass new information and customization to their Suggest analysis. The Already Planned / Will Complete field allows users to include the IDs of culverts they have either recently completed (but passibility is not reflected in the apps data), or have planned and budgeted for those repairs separately. In either case, including the culvert will remove the cost of its repair in the analysis, assume it is now passable, and suggest additional barriers within the users budget as before. Additionally, the added Planned/Completed culverts will be shown as associated habitat in the map but ignored in the new report.
Note: If you don’t know the culvert id, but know their physical locations, simply navigate to those points on the map, click, and copy/paste the id from their call out into the Already Planned / Will Complete field.Once added, click the submit button again.
Map Results:
Including the two culverts to the southwest as already planned / completed, and leaving budget the same, suggests a new third culvert to the northeast, the map indicates potential habitat gains in blue with areas that will remain blocked in red.
Report Results:
Only the unlocked habitat and cost of the new suggestion is given. Note that this particular stream had no species listed, but still reports the total linial gain.
Habitat quantity is a critical metric in environmental assessment and can be quantified in terms of length, area, or volume. By default, length is used as the primary measure.
Note: For area and volume calculations, bankfull width and depth are utilized as outlined in Bieger et al. 2015.
The Objective feature in Upstream provides a more comprehensive analysis of habitat quality. When selecting ‘Weighted Attributes’, the system incorporates various habitat quality metrics, building upon the chosen Habitat Quantity Metric.
This feature allows users to assign weights to different land use types within a 100-meter buffer surrounding the habitat. These land use categories, derived from the National Landcover Dataset, include urban, agricultural, and natural areas. This weighting system enables users to make localized assessments of habitat quality based on land use.
Additionally, the ‘Ideal Habitat Temperature’ option allows users to factor in temperature conditions, further refining the habitat quality analysis.
In the Cost section of Upstream, users have the flexibility to input specific financial details for their projects. This feature is particularly useful for those who have precise cost information at their disposal.
Provide Mean Project Cost: Users can enter the average cost of either the design phase or the construction phase of their culvert projects. This input is invaluable for those who have detailed, project-specific financial data.
Default Modelled Cost Estimates: For users without specific cost data, Upstream offers a default option that utilizes modelled cost estimates. These estimates are based on a comprehensive analysis of regional data and provide a reliable approximation for project budgeting.
This dual approach to cost estimation ensures that users can tailor the financial aspects of their habitat restoration plans according to the level of detail they have, ensuring both accuracy and flexibility in project planning.
The Custom feature on Upstream allows for detailed habitat restoration planning. It enables users to select specific culverts by ID, in addition to setting budget, project area, and ownership types. This feature is ideal for targeted restoration efforts.
To use Custom, start by choosing your project area, budget, and culvert ownership types, similar to the Suggest feature. The unique aspect here is selecting specific culverts by their IDs for a more focused approach. The Custom feature then generates a report detailing habitat gains by salmon species and overall, along with the estimated cost of the plan.
The Learn feature is your comprehensive resource for understanding Upstream. It offers detailed background information about the app, insights into its development, and helpful guidance on how to navigate and utilize its features effectively.
To complement this user manual, we are developing a video tutorial that will provide a visual and interactive guide to Upstream. Your feedback is invaluable to us, so please don’t hesitate to reach out with suggestions or questions to further enrich your learning experience.
Upstream utilizes a variety of data sources to provide accurate and up-to-date information. Below is a list of these sources, detailing their specific contributions to our app.
Culvert (Points) Data
Last updated for app use: 9/1/23.
Excludes natural barriers and barriers upstream of natural barriers.
Additional details and web maps available here.
WSDOT Planned and Corrected Barrier Inventories:
Includes Fish Passage Delivery Plan Sites for 2021-2023, 2023-2025, and 2025-2027.
Statewide data on corrected barriers can be found here.
Streams Data
Provides core flowline, catchment data, and WDB HUC boundaries.
Data acquired using nhdplusTools.
Temperature and Land Use Data
Temperature values are sourced from NHDPlus.
Land use data is derived from the National Landcover Dataset, specifically the 2019 version, offering detailed insights into the surrounding environments of habitats.
Cost Estimates
Legal Boundaries
Golem Framework: The Upstream app was developed using the Golem Shiny application framework. Golem provides a structured and efficient approach for building complex Shiny applications, enhancing maintainability and scalability.
Source Code on GitHub: The source code for Upstream is available on GitHub, promoting transparency and collaboration within the community. This open-source approach allows users to review, contribute, or adapt the code for their own projects.